Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 4 - Geometric Objects / Geometric Objects Reference

Geometric Objects Routines / Creating and Editing Meshes

Q3Mesh_GetVertexIndex

You can use the Q3Mesh_GetVertexIndex function to get the index of a mesh vertex.

TQ3Status Q3Mesh_GetVertexIndex (
TQ3GeometryObject mesh, 
TQ3MeshVertex vertex, 
unsigned long *index);

mesh

A mesh.

vertex

A mesh vertex.

index

On exit, the index of the specified mesh vertex.

DESCRIPTION

The Q3Mesh_GetVertexIndex function returns, in the index parameter, the index of the mesh vertex specified by the mesh and vertex parameters. A vertex index is a unique integer (between 0 and the total number of vertices in the mesh minus 1) associated with a vertex.

WARNING

Vertex indices are volatile and can be changed by functions that alter the topology of a mesh (such as functions that add or delete faces or vertices), and by writing, picking, rendering, or duplicating a mesh, or by calling Q3Mesh_DelayUpdates. As a result, you should rely on an index returned by Q3Mesh_GetVertexIndex only until you perform one of these operations.8batcolor>s